home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr18 / page33.zip / PAGE.DOC < prev    next >
Text File  |  1993-04-10  |  24KB  |  559 lines
  1.  
  2.  
  3.  
  4.                               D o c u m e n t a t i o n
  5.  
  6.                                         f o r
  7.  
  8.                             P   A   G   E   M   A   T   E
  9.  
  10.                       S h a r e w a r e   V e r s i o n   3 . 3
  11.  
  12.         ======================================================================
  13.  
  14.                  Copyright (C) 1991-1993 by R.J. Matter & Associates
  15.                                  All Rights Reserved
  16.  
  17.                            L I M I T E D   W A R R A N T Y 
  18.  
  19.         THIS PROGRAM AND DOCUMENTATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  20.         ANY KIND, EITHER EXPRESSED  OR IMPLIED, INCLUDING, BUT NOT  LIMITED TO
  21.         THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  22.         PURPOSE.  THE ENTIRE RISK  AS TO THE  QUALITY AND  PERFORMANCE OF THIS
  23.         PROGRAM  AND  DOCUMENTATION  IS  WITH  YOU.  SHOULD  THIS  PROGRAM  OR
  24.         DOCUMENTATION PROVE  DEFECTIVE, YOU  (NOT THE AUTHOR,  DISTRIBUTOR, OR
  25.         DEALER)  ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR
  26.         CORRECTION. IN NO  EVENT WILL  THE AUTHOR, DISTRIBUTOR,  OR DEALER  BE
  27.         LIABLE  TO YOU  FOR  ANY DAMAGES,  INCLUDING  ANY LOST  PROFITS,  LOST
  28.         SAVINGS, OR OTHER INCIDENTAL  OR CONSEQUENTIAL DAMAGES ARISING  OUT OF
  29.         THE USE OR INABILITY TO USE  THIS PROGRAM OR DOCUMENTATION EVEN IF THE
  30.         AUTHOR,  DISTRIBUTOR, OR DEALER HAS BEEN ADVISED OF THE POSSIBILITY OF
  31.         SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  32.  
  33.         ======================================================================
  34.  
  35.  
  36.                                           by
  37.  
  38.                                    Robert J. Matter
  39.  
  40.                                     P.O. BOX 9042
  41.  
  42.                                Highland, IN 46322-9042
  43.  
  44.  
  45.                                 Voice: (219) 845-5247
  46.  
  47.  
  48.                                         E-MAIL
  49.  
  50.                                    GEnie: R.Matter
  51.  
  52.                                 CompuServe: 71021,2654
  53.  
  54.                              America On-Line: Robert7063
  55.  
  56.                          Internet: 71021.2654@compuserve.com
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                           1
  64.  
  65.  
  66.                                                                   PageMate 3.3
  67.  
  68.  
  69.                                 D E S C R I P T I O N
  70.  
  71.         PageMate  is  a  program that  monitors  your  telephone  line for  an
  72.         incoming ring  and then dials  a number  you specify after  a specific
  73.         delay. It also  includes an alarm facility to call  your pager (or any
  74.         other  number) at  a predefined date  and time  and optionally  send a
  75.         phone  number you are supposed to call  at that time. All incoming and
  76.         outgoing calls are logged to a file for later examination. 
  77.  
  78.         PageMate is most commonly used in conjunction with display type pagers
  79.         (or  "beepers") and  answering machines  to notify owners  of incoming
  80.         messages,  but it  can  call any  telephone  number and  an  answering
  81.         machine is not necessary. PageMate will work with rotary pulse or tone
  82.         telephone line service.
  83.  
  84.  
  85.                                    F E A T U R E S
  86.  
  87.              *    Supports any COM port (1-25) and IRQ (0-15)
  88.  
  89.              *    IRQ's can be shared among other serial devices
  90.  
  91.              *    100 entry  "Alarm" function with  user selectable Month-Day,
  92.                   Hour:Minute or wildcards
  93.  
  94.              *    Each alarm entry can send a unique "number to call"
  95.  
  96.              *    Incoming calls and outgoing alarm calls logged to disk
  97.  
  98.              *    Can run in the background under Windows 3.1 (Enhanced Mode)
  99.  
  100.              *    Redials if number called was busy
  101.  
  102.              *    Won't interrupt if telephone is in use
  103.  
  104.              *    User defined "hang-up" time
  105.  
  106.              *    Support for  several brands of multi-port  serial cards that
  107.                   have the 8250/16450/16550 or compatible serial chip  
  108.  
  109.  
  110.              H A R D W A R E / S O F T W A R E   R E Q U I R E M E N T S
  111.  
  112.              *    IBM PC or compatible computer with MS-DOS 2.0 or higher
  113.  
  114.              *    300 baud or greater Hayes or compatible modem
  115.  
  116.              *    One floppy or hard disk drive
  117.  
  118.              *    A text editor or word processor
  119.  
  120.              *    A telephone line
  121.  
  122.              *    Digital pager (optional)
  123.  
  124.  
  125.                                           2
  126.  
  127.  
  128.                                                                   PageMate 3.3
  129.  
  130.  
  131.                                       S E T U P
  132.  
  133.                      S T E P   1   -   E D I T   P A G E . D A T
  134.  
  135.         PageMate is compatible with a wide variety of hardware configurations.
  136.         To facilitate this flexibility a more detailed set of setup
  137.         instructions is necessary than in pre-3.X versions. One COMMA
  138.         SEPARATED setup line is required in the PAGE.DAT file in the format:
  139.  
  140.         COM PORT#, SERIAL PORT ADDRESS, IRQ NUMBER, BAUD RATE, LINE SERVICE,
  141.         DELAY TIME, "BEEPER NUMBER", NUMBER TO DISPLAY, HANG-UP TIME,
  142.         ENABLE/DISABLE REDIAL 
  143.  
  144.         Example:  1, 3F8, 4, 2400, T, 180, "555-5555,,,,", 999-9999#, 20, 1
  145.  
  146.         Sample setup lines have been provided in PAGE.DAT for the four most
  147.         common configurations. With any luck you will only need to copy one of
  148.         them to the top line. The other sample setup lines can be left in
  149.         PAGE.DAT for future reference because PageMate only reads the first
  150.         line.
  151.  
  152.         With a text editor such as DOS 5.0's "Edit" or a word processor, edit
  153.         setup line to include: 
  154.  
  155.         1)   COM PORT# [1-25]. The COM port number your modem is installed on.
  156.              This is usually 1 through 4 for most PC's with standard serial
  157.              ports or internal modems.
  158.  
  159.         2)   SERIAL PORT ADDRESS [000-3FF]. The hexadecimal address of the
  160.              selected COM port. The conventional address values for most PC'S
  161.              are:
  162.  
  163.                             Port      Address
  164.                             -----     ------
  165.                             COM1      3F8
  166.                             COM2      2F8
  167.                             COM3      3E8
  168.                             COM4      2E8
  169.  
  170.              Internal modems and normal serial cards usually have dip switches
  171.              or jumpers  indicating the COM  port and address.  Many computers
  172.              display installed serial device addresses when booting up.
  173.  
  174.         3)   IRQ NUMBER  [0-15]. The table  below shows common  IRQ (Interrupt
  175.              Request) values, but yours may  vary. PageMate allows sharing  of
  176.              IRQ's so  for example if you  already have a serial  card on COM1
  177.              using IRQ 4 you  can install an internal modem configured as COM3
  178.              using IRQ 4 also. 
  179.  
  180.                             Port      IRQ
  181.                             ----      ---
  182.                             COM1       4 
  183.                             COM2       3 
  184.                             COM3       4  (sometimes 5 or 7)
  185.                             COM4       3  (sometimes 5 or 7)
  186.  
  187.                                           3
  188.  
  189.  
  190.                                                                   PageMate 3.3
  191.  
  192.  
  193.         4)   BAUD  RATE [300,  1200, 2400].  The  baud rate  has no  effect on
  194.              PageMate since  it is not  communicating with another  modem. The
  195.              alternatives  are for users who  have fixed rate  modems. You can
  196.              use the highest  or lowest  baud rate your  modem supports.  Note
  197.              however  that most modems cannot recognize  if the telephone line
  198.              is in use ("off hook") at 300 baud.
  199.  
  200.         5)   LINE SERVICE [P,T]. Indicates rotary  Pulse dialing or touch Tone
  201.              dialing.  Note that manually dialing  out on a  rotary pulse line
  202.              while  PageMate is  running may cause  PageMate to  interpret the
  203.              "clicks" as an incoming ring.
  204.  
  205.         6)   DELAY  TIME.  Number  of  seconds PageMate  should  delay  before
  206.              calling the pager. If  you are using an answering  machine, allow
  207.              caller  enough time to leave message and for single-tape machines
  208.              to rewind. Usually 3-5 minutes (180-300 seconds) is sufficient. 
  209.  
  210.         7)   "BEEPER NUMBER".  The paging  service telephone number  (or other
  211.              number)  PageMate is  to call.  Special characters  surrounded by
  212.              quotation  marks ("  "). Spaces,  dashes, and parentheses  can be
  213.              included for readability  and are usually ignored  by modems. The
  214.              default pause of a comma on industry standard modems is usually 2
  215.              seconds. I  found that  8 seconds is  enough time  for my  paging
  216.              service to  answer before I send the number to be displayed so my
  217.              pager number string looks something like this:
  218.  
  219.                                     "555-5555,,,,"
  220.  
  221.              Translation: Dial  555-5555 and wait for 8 seconds before sending
  222.              the number to be displayed on pager. Example #2:
  223.  
  224.                                   ",9,555-5555,,,,"
  225.  
  226.              Translation: Wait 2  seconds for a  dial tone, dial  9 to get  an
  227.              outside line,  wait 2 seconds for the second dial tone, then dial
  228.              555-5555  and  wait 8  seconds before  sending  the number  to be
  229.              displayed on pager.
  230.  
  231.              DO NOT FORGET TO SURROUND THIS ENTRY WITH QUOTATION MARKS! 
  232.  
  233.              Special characters like asterisks (*) can be entered as well. For
  234.              instance,  to disable call waiting on tone service lines an entry
  235.              might look like this:
  236.  
  237.                                  "*70,555-5555,,,,".
  238.  
  239.              An  entry to disable call  waiting on rotary  pulse service lines
  240.              might look like this:
  241.  
  242.                                  "1170,555-5555,,,,".
  243.  
  244.              The  values  to disable  call waiting  may  be different  in your
  245.              locale.
  246.  
  247.  
  248.  
  249.                                           4
  250.  
  251.  
  252.                                                                   PageMate 3.3
  253.  
  254.  
  255.         8)   NUMBER  TO DISPLAY. The telephone  number to be  displayed on the
  256.              pager. Note: Tone line  service is necessary to transmit  numbers
  257.              to the paging service. This number does not have to be surrounded
  258.              in  quotation marks if it  contains no commas.  Suffix the number
  259.              with a pound sign (#) or other character  required by your paging
  260.              service to indicate transmission completed. Example:
  261.  
  262.                                       999-9999#.
  263.  
  264.              If you  don't have tone line  service simply put a  digit in this
  265.              field for a place holder.
  266.  
  267.         9)   HANG-UP TIME. The  number of  seconds to wait  after the  dialing
  268.              string is sent  to the  modem before hanging  up the line.  Allow
  269.              enough  time for the pager  service's phone to  ring, answer, and
  270.              receive your transmission. I find that 20 seconds is adequate for
  271.              my dialing string, but yours may differ. 20-40 seconds is usually
  272.              adequate.
  273.  
  274.         10)  ENABLE/DISABLE  REDIAL [1,0].  1  = Redial  enabled,  0 =  Redial
  275.              disabled. If redial  is enabled, PageMate will  redial the number
  276.              if a busy signal was sensed on the previous attempt. If redial is
  277.              disabled, PageMate will  NOT attempt  to redial the  number if  a
  278.              busy signal was sensed on the previous attempt.
  279.  
  280.              Note: Some older paging systems transmit a busy signal at the end
  281.              of the  call  to indicate  that  the transmission  was  received.
  282.              PageMate will sense  that busy  signal and attempt  to redial  if
  283.              redialing  is enabled  [1].  If you  have  that type  of  system,
  284.              disable redialing with a [0].     
  285.  
  286.  
  287.         MAKE SURE  THE PARAMETERS ARE IN  THE EXACT ORDER SHOWN  AND THAT EACH
  288.         PARAMETER IS SEPARATED BY A COMMA (,)!
  289.  
  290.         Also be careful to  enter a zero (0) where  you need a digit,  not the
  291.         letter "O". The computer discerns these as different characters!
  292.  
  293.         You need only edit PAGE.DAT once if there were no mistakes. It will be
  294.         stored on your disk and accessed by PageMate each time  the program is
  295.         started.
  296.  
  297.         If  you are using a multi-port card  and can't get PageMate to operate
  298.         properly with the parameter settings above, you will need to request a
  299.         special version of PageMate from the author that allows for additional
  300.         parameters to be set. Specify the brand and model number of the card.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.                                           5
  312.  
  313.  
  314.                                                                   PageMate 3.3
  315.  
  316.  
  317.                     S T E P   2   -   E D I T   A L A R M . D A T
  318.  
  319.         An  alarm function is provided to activate PageMate at different dates
  320.         and times specified in the ALARM.DAT file. 100 different alarm entries
  321.         can be included. Like PAGE.DAT, ALARM.DAT  is an ASCII text file so if
  322.         you use  a word processor for  editing make sure to  save ALARM.DAT in
  323.         ASCII text format,  not document  format. Alarm entries  consist of  4
  324.         fields delimited (separated) by commas in the format:
  325.  
  326.              MM-DD,HH:mm,NUMBER TO DISPLAY,COMMENTS WITHOUT COMMAS
  327.  
  328.         Where     MM = Month to call (01-12 or ** for every month)
  329.                   DD = Day to call (01-31 or ** for every day)
  330.                   HH = Hour to call in MILITARY TIME (00-23)
  331.                   mm = Minute to call (00-59)
  332.                   Optional number to send to your pager
  333.                   Optional comments of your own (can be any length as  long as
  334.                   no commas are included)
  335.  
  336.         THE ALARM.DAT FILE  INCLUDED WITH  PAGEMATE HAS ONE  DUMMY ENTRY  (SEE
  337.         BELOW) WHICH SHOULD NOT  BE DELETED BECAUSE ALARM.DAT MUST  CONTAIN AT
  338.         LEAST ONE ENTRY FOR PAGEMATE  TO RUN, AND IT ALSO SERVES AS A TEMPLATE
  339.         FOR FUTURE REFERENCE!
  340.  
  341.                00-00,00:00,555-5555#, *** DUMMY ENTRY DO NOT DELETE ***
  342.  
  343.         Here are some other example entries with explanations:
  344.  
  345.           08-01,14:35,111-222-3333#, Call restaurant for dinner reservations
  346.  
  347.         Translation:  PageMate is  to  call on  August 1st  at  2:35 P.M.  and
  348.         display  the  number (with  area code)  111-222-3333.  The call  is to
  349.         remind you to call a restaurant to make dinner reservations.
  350.  
  351.         If you want PageMate to call you at a specified date and time and just
  352.         display your regular number  as defined in PAGE.DAT, leave  the number
  353.         to  display field blank BUT INCLUDE THE COMMA SEPARATORS. For example:
  354.  
  355.  
  356.                                     09-28,10:30,, 
  357.  
  358.         Translation: Have  PageMate  call on  September  28th at  10:30  A.M.,
  359.         display normal number specified in PAGE.DAT, no user comments. With an
  360.         optional comment the entry would like this:
  361.  
  362.                           09-28,10:30,, Dentist appointment 
  363.  
  364.         Two asterisks  (**) can be used for wildcards (any match) in the month
  365.         or day positions. For example:
  366.  
  367.                           **-**,11:00,, Take heart medicine
  368.  
  369.         Translation: Have PageMate call every day of every month at 11:00 A.M.
  370.         to remind you to take medication.
  371.  
  372.  
  373.                                           6
  374.  
  375.  
  376.                                                                   PageMate 3.3
  377.  
  378.  
  379.            **-17,13:00,222-2222, Call beauty salon for monthly appointment
  380.  
  381.         Translation: Have PageMate  call on  the 17th of  every month at  1:00
  382.         P.M.  to remind you to make an  appointment. The number 222-2222 is to
  383.         display on your pager.
  384.  
  385.                               09-**,22:00,, Wake up call
  386.  
  387.         Translation:  Have PageMate call everyday of the month of September at
  388.         10: P.M. to wake you up for the midnight shift.
  389.  
  390.                           A L A R M   R U L E  S U M M A R Y
  391.  
  392.         A  separator character is required between the  month and day and also
  393.         between the  hour and minutes. You  can use any character  including a
  394.         space for a separator, however PageMate will insert  a "-" between the
  395.         month day  and a  ":" between  the hour and  minutes when  activity is
  396.         logged to PAGE.LOG. 
  397.  
  398.         Time to  call must  be in  MILITARY TIME, i.e.,  number of  hours past
  399.         midnight where midnight = 00:00. For example:
  400.  
  401.                        6:00 A.M. = 06:00 (6 hours past midnight)
  402.                        Noon      = 12:00 (12 hours past midnight)
  403.                        6:00 P.M. = 18:00 (18 hours past midnight)
  404.  
  405.         Single digit date and time entries are padded with a zero (1 = 01). 
  406.  
  407.         The four  fields are separated by  commas, and there are  no commas in
  408.         the comment field.
  409.  
  410.         Dates  and times  do not  have  to be  entered in  sorted order.  Tip:
  411.         Include  entries to remind you of birthdays, anniversaries, long range
  412.         appointments,  gatherings, etc.  Because there  is no  year specified,
  413.         those entries  will be valid for future years! Remember to account for
  414.         seasonal time adjustments "Spring ahead, Fall back" when creating long
  415.         term entries.
  416.  
  417.         PageMate checks for  errors in the  alarm file during start-up.  If an
  418.         error was found, PageMate will abort and display the error that caused
  419.         the  problem, diagnostic  message,  and the  line number  of ALARM.DAT
  420.         where the error was found.
  421.  
  422.         Make sure  the DOS "End  Of File" character  is immediately  after the
  423.         last entry in ALARM.DAT (no blank lines between the last entry and the
  424.         End of File character). Many text editors will display an  End Of File
  425.         character  or message. If you  use DOS 5.0's  "Edit" program, position
  426.         cursor on blank line immediately after  the last alarm entry and press
  427.         "Ctrl-Y" several times until a  beeping sound is heard, then save  the
  428.         file (Alt-F,X,Y).
  429.  
  430.         PageMate will  not call alarm entries  that have a date  and time less
  431.         than the date and time at start-up.
  432.  
  433.  
  434.  
  435.                                           7
  436.  
  437.  
  438.                                                                   PageMate 3.3
  439.  
  440.  
  441.                      O P E R A T I N G   I N S T R U C T I O N S
  442.  
  443.         The  modem and telephone/answering machine  must be on  the same line.
  444.         The computer and  modem must be turned on. Internal  modems are always
  445.         on when the  computer is  on. PAGE.EXE, PAGE.DAT,  AND ALARM.DAT  MUST
  446.         RESIDE IN THE SAME DIRECTORY.
  447.  
  448.                           S T A R T I N G   P A G E M A T E
  449.  
  450.         Type  "PAGE" to  start the  program. The  PageMate status  window will
  451.         appear  and after a few moments of modem/port initialization, the date
  452.         and time  will  be displayed  and  the seconds  should  be ticking.  A
  453.         "Waiting for next call..." message will appear.
  454.  
  455.         If everything is  installed and  working correctly, you  can turn  off
  456.         your monitor  and leave  PageMate and  your computer unattended.  When
  457.         PageMate  detects the first incoming  ring on your  telephone line, it
  458.         will begin counting down  the delay seconds you specified  in PAGE.DAT
  459.         and then call the dialing string you specified in PAGE.DAT.
  460.  
  461.         PageMate will not call if your telephone line is in use (off the hook)
  462.         and your  baud rate  is set  at 1200  or 2400.  If you have  redialing
  463.         enabled  and PageMate encountered a  busy signal when  dialing out, it
  464.         will re-try the number until it gets through.
  465.  
  466.                                     T E S T I N G
  467.  
  468.         You can test PageMate any time by pressing "t"  or "T". The delay time
  469.         for  test mode varies according to the length of the specified dialing
  470.         string.
  471.  
  472.                                     E X I T I N G
  473.  
  474.         You can exit PageMate at any time by pressing the Escape key.
  475.  
  476.  
  477.                                    ACTIVITY LOGGING
  478.  
  479.         All incoming and outgoing call activity is automatically recorded in a
  480.         file named PAGE.LOG in the same directory where PageMate resides. This
  481.         file  is not  included  with the  distribution files  because PageMate
  482.         creates it if  it is not  found at start-up  time. Test calls  are not
  483.         logged.
  484.  
  485.         PAGE.LOG IS NOT DELETED BY PAGEMATE, SO OCCASIONALLY YOU WILL NEED  TO
  486.         DELETE IT WHEN IT GETS LARGER THAN DESIRED!
  487.  
  488.         PAGE.LOG can  be examined or printed any time with a word processor or
  489.         text editor or a DOS command such as PRINT PAGE.LOG or TYPE PAGE.LOG.
  490.  
  491.         Call activity is recorded in the same format as ALARM.DAT:
  492.  
  493.                   MM-DD HH:mm *** Call Received*** (for incoming calls)
  494.                   MM-DD HH:mm [Number to Display] [Comment] (for alarm calls)
  495.  
  496.  
  497.                                           8
  498.  
  499.  
  500.                                                                   PageMate 3.3
  501.  
  502.  
  503.                     S H A R E W A R E   V E R S I O N    N O T E S
  504.  
  505.         The  full 100 entry alarm  feature with logging  is enabled. Unlimited
  506.         testing is also  enabled. However, the  SHAREWARE VERSION of  PageMate
  507.         allows only one incoming call (and corresponding log) per session. You
  508.         must  register  in order  to receive  the  unlimited call  version. To
  509.         register,  print and fill out PAGE.FRM and  mail it with your check or
  510.         money payable to R.J. Matter for $35 to: 
  511.  
  512.                                  R.J. Matter - PageMate
  513.                                  P.O. BOX 9042
  514.                                  Highland, IN  46322-9042
  515.  
  516.         Orders are shipped First Class Mail on the same day received. Overseas
  517.         orders  add  $5.  Dealer  inquiries  welcome.  Call  regarding  custom
  518.         development.
  519.  
  520.  
  521.                                D I S T R I B U T I O N
  522.  
  523.         This  software  may   be  distributed  freely  provided   that  it  is
  524.         distributed  as   a  complete  set  (ALARM.DAT,   PAGE.DAT,  PAGE.DOC,
  525.         PAGE.EXE, PAGE.FRM,  PAGE.ICO, PAGE.PIF) without  modification and  no
  526.         fee  is charged  other than a  nominal handling or  duplication fee of
  527.         $5.00 or less.
  528.  
  529.                                       F I L E S
  530.  
  531.                        ALARM.DAT -  Alarm Data File
  532.                        PAGE.DAT  -  PageMate setup file
  533.                        PAGE.DOC  -  PageMate Documentation
  534.                        PAGE.EXE  -  PageMate Executable Program
  535.                        PAGE.FRM  -  PageMate Registration Form
  536.                        PAGE.ICO  -  PageMate Icon for Windows
  537.                        PAGE.LOG  -  PageMate Log File (created - not included)
  538.                        PAGE.PIF  -  PageMate Program Information File
  539.                                     for Windows 3.1 Enhanced Mode 
  540.  
  541.                              PageMate 3.X RELEASE HISTORY
  542.  
  543.         Version 3.0    Added COM1-25 support, alarm facility, & logging.
  544.         Version 3.1    Added enable/disable redial on busy signal switch.
  545.         Version 3.2    Maintenance release for 9600 baud modem support.
  546.         Version 3.3    Added Windows compatibility, improved modem support.
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.                                           9